home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / gfx / show / mpeg_player122.lha / amiga / mpeg_play.doc < prev    next >
Text File  |  1992-12-11  |  5KB  |  199 lines
  1.  
  2.  
  3.  
  4. MPEG_PLAY(1)                                         MPEG_PLAY(1)
  5.  
  6.  
  7. NAME
  8.        mpeg_play - plays mpeg­1 encoded bitstreams using X11
  9.  
  10. SYNOPSIS
  11.        mpeg_play  [  ­nob  ] [ ­nop ] [ ­dither dither_option ] [
  12.        ­loop ] [ ­eachstat ] file_name
  13.  
  14. DESCRIPTION
  15.        mpeg_play decodes and displays mpeg­1  encoded  bitstreams
  16.        on systems running X11.  The player will create a new win­
  17.        dow, display the bitstream, and exit.  Any error  messages
  18.        or notices are sent to stderr.
  19.  
  20. OPTIONS
  21.        ­nob  :  causes the player to ignore and not display any B
  22.               frames.
  23.  
  24.        ­nop : causes the player to ignore and not display  any  P
  25.               frames.
  26.  
  27.        ­dither  dither_option  : selects from a variety of dither
  28.               options. The possible values are:
  29.  
  30.               ordered ­ ordered dither. This is the default.
  31.  
  32.               fs4 ­ Floyd­Steinberg dithering with 4 error values
  33.                      propogated.
  34.  
  35.               fs2 ­ Floyd­Steinberg dithering with 2 error values
  36.                      propogated.
  37.  
  38.               fs2fast ­ Fast  Floyd­Steinberg  dithering  with  2
  39.                      error values propogated.
  40.  
  41.               hybrid ­ Hybrid dithering, a combination of ordered
  42.                      dithering  for  the  luminance  channel  and
  43.                      Floyd­Steinberg  2  error  dithering for the
  44.                      chrominance channels. Errors  are  NOT  pro­
  45.                      pogated   properly   and   are  dropped  all
  46.                      togethor every two pixels in  either  direc­
  47.                      tion.
  48.  
  49.               hybrid2 ­ Hybrid dithering as above, but with error
  50.                      propogation among pixels.
  51.  
  52.               2x2 ­ A dithering technique using a 2x2 pixel  area
  53.                      for  each  pixel.  The  image displayed is 4
  54.                      times  larger  than   the   original   image
  55.                      encoded.  Random  error  terms  are added to
  56.                      each pixel to break up contours  and  gradi­
  57.                      ents.
  58.  
  59.               gray  ­  Grayscale dithering. The image is dithered
  60.                      into 128 grayscales. Chrominance information
  61.  
  62.  
  63.  
  64.                          30 November 1992                       1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MPEG_PLAY(1)                                         MPEG_PLAY(1)
  71.  
  72.  
  73.                      is thrown away.
  74.  
  75.               color  ­  Full  color display (only available on 24
  76.                      bit color displays).
  77.  
  78.               none ­ no dithering is done, no image is displayed.
  79.                      Used to time decoding process.
  80.  
  81.               mono  ­  Floyd­Steinberg  dithering  for monochrome
  82.                      displays.
  83.  
  84.               threshold ­ Floyd­simple dithering  for  monochrome
  85.                      displays.
  86.  
  87.        ­loop  : makes the player loop back to the beginning after
  88.               reaching the end.
  89.  
  90.        ­eachstat : causes statistics to be displayed  after  each
  91.               frame. Only valid when compiled with ­DANALYSIS.
  92.  
  93.        ­shmem_off : turns shared memory off.
  94.  
  95. NOTES
  96.        The  player  expects MPEG­1 video streams only. It can not
  97.        handle multiplexed MPEG streams  or  video+audio  streams.
  98.        The  player uses the paris entropy coding table set (which
  99.        we believe to be the MPEG­1 standard), but can not  handle
  100.        any  bitstreams that use the "berlin" entropy coding table
  101.        set. Berlin data is relatively rare so there shouldn't  be
  102.        too  much to worry about here, but be aware of the differ­
  103.        ence when looking for streams to play.
  104.  
  105.        Most streams do not end with the proper sequence end  code
  106.        and  will probably generate an "Unexpected EOF" error when
  107.        done playing.
  108.  
  109.        This player can play XING data files. Be aware  that  XING
  110.        makes  no  use  of  temporal  redundancy  or motion vector
  111.        information. In other words, they do not use any  P  or  B
  112.        frames  in  their  streams. Instead, XING data is simply a
  113.        sequence of I frames. Since I  frames  take  significantly
  114.        longer  to  decode,  performance  of the player using XING
  115.        data is not representative of the player's ability.
  116.  
  117. AUTHORS
  118.        Ketan Patel ­ University  of  California,  Berkeley,  kpa­
  119.               tel@cs.berkeley.edu
  120.  
  121.        Brian   Smith   ­   University  of  California,  Berkeley,
  122.               bsmith@cs.berkeley.edu
  123.  
  124.        Henry Chi­To Ma  ­  University  of  California,  Berkeley,
  125.               cma@cs.berkeley.edu
  126.  
  127.  
  128.  
  129.  
  130.                          30 November 1992                       2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. MPEG_PLAY(1)                                         MPEG_PLAY(1)
  137.  
  138.  
  139.        Kim   Man   Liu  ­  University  of  California,  Berkeley,
  140.               kliu@cs.berkeley.edu
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                          30 November 1992                       3
  197.  
  198.  
  199.